<!--
  ~ Copyright (C) 2010 Brockmann Consult GmbH (info@brockmann-consult.de)
  ~
  ~ This program is free software; you can redistribute it and/or modify it
  ~ under the terms of the GNU General Public License as published by the Free
  ~ Software Foundation; either version 3 of the License, or (at your option)
  ~ any later version.
  ~ This program is distributed in the hope that it will be useful, but WITHOUT
  ~ ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  ~ FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
  ~ more details.
  ~
  ~ You should have received a copy of the GNU General Public License along
  ~ with this program; if not, see http://www.gnu.org/licenses/
  -->

<html>
<head>
    <title>Sentinel Toolbox Help - Mosaic</title>
    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
    <link rel="stylesheet" href="../style.css">
</head>

<body>
<table class="header">
    <tr class="header">
        <td class="header">&nbsp;
            Mosaic
        </td>
        <td class="header" align="right"><a href="../general/overview/SnapOverview.html"><img src="../images/snap_header.jpg"
                                                                                     border=0></a></td>
    </tr>
</table>

<h3>Mosaic Dialog</h3>

<h4>I/O Parameters</h4>
<table border="0">
    <tr>
        <td style="border-width:0;" valign="top">
            <h5>Source Products</h5>

            <p class="i1">
                Specify the source products which shall be combined to one mosaic.<br>
                <img src="images/icons/Plus24.gif"> Lets you choose one or multiple products from the file
                system.<br>
                <img src="images/icons/Minus24.gif"> Removes the currently selected product from the list of source
                products.<br>

            <h5>Target Product</h5>

            <p class="i1">
                <b>Update target product:</b>
                If selected, all processing parameters are taken from the output product which must
                already exists. Modification of all parameters is disabled in this mode. If 'Run' is pressed, the output
                product is updated with the given input files. If not selected, a new
                mosaic output product will be created.
            </p>

            <p class="i1">
                <b>Name:</b>
                Used to specify the name of the target product.
            </p>

            <p class="i1">
                <b>Save as:</b>
                Used to specify whether the target product should be saved to the file system. The
                combo box presents a list of file formats, currently BEAM-DIMAP, GeoTIFF, and HDF5.
                The text field allows to specify a target directory. <br>
                The target product must be saved, so you can not uncheck this option.
            </p>

            <p class="i1">
                <b>Open in ESA SNAP:</b>
                Used to specify whether the target product should be opened in the Sentinel Toolbox.
                When the target product is not saved, it is opened in the Sentinel Toolbox automatically.
            </p></td>
        <td style="border-width:0;" valign="top">
            <img src="images/MosaicIOParameters.png">
        </td>
    </tr>
</table>

<h4>Map Projection Definition</h4>
<table border="0">
    <tr>
        <td style="border-width:0;" valign="top">
            <h5>Coordinate Reference System (CRS)</h5>

            <p class="i1">
                <b>Custom CRS:</b>
                The transformation used by the projection can be selected. Also the geodetic datum and
                transformation parameters can be set, if possible for the selected transformation.
            </p>

            <p class="i1">
                <b>Predefined CRS:</b>
                By clicking on the <b>Select...</b> button a new <a href="SelectCrsDialog.html">Select Coordinate Reference System Dialog</a> is shown
                where a predefined CRS can be selected.
            </p>
            <h5>Orthorectification</h5>

            <p class="i1">
                <b>Orthorectify input products:</b>
                If selected the source products are not only reprojected to the defined CRS but also orthorectified.
            </p>

            <p class="i1">
                <b>Elevation model:</b>
                You can select the digital elevation model which should be used for
                <a href="OrthorectificationAlgo.html">orthorectification</a>. Either you use the internal elevation
                model of
                the product or an external DEM. If you select an external DEM and it is currently not installed on your
                system,
                a dialog will appear to enable you to download and install the DEM.<br>
                Currently there is only the <a href="GETASSE30ElevationModel.html">GETASSE30 DEM</a> available.
            </p>
            <h5>Mosaic Bounds</h5>

            <p class="i1">
                <b>West:</b>
                Specifies the western bound in degree which is guaranteed to be within the geographical
                boundary of the output product.
            </p>

            <p class="i1">
                <b>East:</b>
                Specifies the eastern bound in degree which is guaranteed to be within the geographical
                boundary of the output product.
            </p>

            <p class="i1">
                <b>North:</b>
                Specifies the northern bound in degree which is guaranteed to be within the geographical
                boundary of the output product.
            </p>

            <p class="i1">
                <b>South:</b>
                Specifies the southern bound in degree which is guaranteed to be within the geographical
                boundary of the output product.
            </p>

            <p class="i1">
                <b>Pixel size X:</b>
                Specifies the pixel size in X direction of the output product in map units.
            </p>

            <p class="i1">
                <b>Pixel size Y:</b>
                Specifies the pixel size in Y direction of the output product in map units.
            </p>

            <p class="i1">
                <b>World Map:</b>
                The world map in which the geographical boundary of the resulting output product is displayed.
            </p>

            <p class="i1">
                <b>Display source products:</b>
                If selected the geographic boundaries of the source products are also displayed in the world map.
            </p>
        </td>
        <td style="border-width:0;" valign="top">
            <img src="images/MosaicProjectionParameters.png">
        </td>
    </tr>
</table>

<h4>Variables & Conditions</h4>
<table border="0">
    <tr>
        <td style="border-width:0;" valign="top">
            <h5>Variables</h5>

            <p class="i1">Defines the list of output variables. <br>
                A variable is composed of a name and a data source expression.
                The expression can be composed of mathematical operators, functions and symbols referencing the flags
                and bands defined in the input products, e.g. <code>"0.5 * (radiance_11 + radiance_13)"</code> or
                even boolean expressions such as <code>"(radiance_13 > 50.0) AND NOT l1_flags.INVALID"</code>.
                By double-clicking into the expression field you can open the expression editor.<br>
                <img src="images/icons/Copy24.gif"> Add a band directly as variable.<br>
                <img src="images/icons/Plus24.gif"> Add a new variable.<br>
                <img src="images/icons/Minus24.gif"> Removes the currently selected variable from the list.<br>
                <img src="images/icons/MoveUp24.gif"> Moves the currently selected variable one line up.<br>
                <img src="images/icons/MoveDown24.gif"> Moves the currently selected variable one line down..<br>
            </p>
            <h5>Conditions</h5>

            <p class="i1">Defines the list of valid pixel conditions. <br>
                A condition is composed of a name and a test expression.
                The boolean test expression can be composed of mathematical operators, functions and symbols referencing
                the flags and bands defined in the input products, e.g. <code>"(radiance_13 > 50.0) AND NOT
                    l1_flags.INVALID"</code>.
                By double-clicking into the expression field you can open the expression editor. By selecting the
                'Outp.' toggle you can output the number of times a condition returned "true" for an output product
                pixel.<br>
                <img src="images/icons/Plus24.gif"> Add a new condition.<br>
                <img src="images/icons/Minus24.gif"> Removes the currently selected condition from the list.<br>
                <img src="images/icons/MoveUp24.gif"> Moves the currently selected condition one line up.<br>
                <img src="images/icons/MoveDown24.gif"> Moves the currently selected condition one line down..<br>
            <p class="i1">
                <b>Combine:</b>
                If more than one valid pixel condition is given, they are combined using the
                condition operator which can take the values <code>AND</code> or <code>OR</code>. If the value is <code>AND</code>
                all criteria must be fulfilled to consider a given pixel in the output product.</p>

        </td>
        <td style="border-width:0;" valign="top">
            <img src="images/MosaicVariablesAndConditions.png">
        </td>
    </tr>
</table>


<hr>
</body>
</html>
